Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Alternate Tracks

SetAutoTrackAlternatesEnabled

The SetAutoTrackAlternatesEnabled function allows your application to enable and disable automatic track selection by the Movie Toolbox.

pascal void SetAutoTrackAlternatesEnabled (Movie theMovie, 
                                             Boolean enable);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

enable

Controls automatic track selection. Set this parameter to true to enable automatic track selection. Set this parameter to false to disable automatic track selection.

DESCRIPTION

If automatic track selection is enabled, the Movie Toolbox selects appropriate tracks whenever your application calls the SetMovieGWorld, SetMovieBox, UpdateMovie, or SetMovieMatrix functions (described on page 2-145, page 2-146, page 2-112, and page 2-155, respectively). When you enable automatic track selection, the Movie Toolbox immediately selects enabled tracks for the movie. This overrides the setting of the newMovieDontAutoAlternate flag (see page 2-79 for details on this flag).

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

You can instruct the Movie Toolbox to select appropriate tracks immediately by calling the SelectMovieAlternates function, which is described in the previous section.